(kill-region, kill-line, kill-ring-save): Doc fix.

diff --git a/lisp/simple.el b/lisp/simple.el
index bb8f3c72126d4eb9d0842e78f8c9f9905bde2919..510c07e8ddc8c68dc0706ab0c83c8a1b22c479c7 100644 (file)
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -1753,7 +1753,11 @@ yanking point; just return the Nth kill forward."
   "Kill between point and mark.
 The text is deleted but saved in the kill ring.
 The command \\[yank] can retrieve it from there.
-\(If you want to kill and then yank immediately, use \\[copy-region-as-kill].)
+\(If you want to kill and then yank immediately, use \\[kill-ring-save].)
+
+If you want to append the killed region to the last killed text,
+use \\[append-next-kill] before \\[kill-region].
+
 If the buffer is read-only, Emacs will beep and refrain from deleting
 the text, but put the text in the kill ring anyway.  This means that
 you can use the killing commands to copy text from a read-only buffer.
@@ -1813,6 +1817,9 @@ In Transient Mark mode, deactivate the mark.
 If `interprogram-cut-function' is non-nil, also save the text for a window
 system cut and paste.
 
+If you want to append the killed line to the last killed text,
+use \\[append-next-kill] before \\[kill-ring-save].
+
 This command is similar to `copy-region-as-kill', except that it gives
 visual feedback indicating the extent of the region being copied."
   (interactive "r")
@@ -2015,6 +2022,9 @@ including its terminating newline, when used at the beginning of a line
 with no argument.  As a consequence, you can always kill a whole line
 by typing \\[beginning-of-line] \\[kill-line].
 
+If you want to append the killed line to the last killed text,
+use \\[append-next-kill] before \\[kill-line].
+
 If the buffer is read-only, Emacs will beep and refrain from deleting
 the line, but put the line in the kill ring anyway.  This means that
 you can use this command to copy text from a read-only buffer."